home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / comm / pickup14.zip / PICKUP14.DOC < prev    next >
Text File  |  1993-12-04  |  35KB  |  905 lines
  1.  
  2.                              **** PICK-UP ****
  3.  
  4.                       File Manager/Uploader for Telix
  5.                                 Version 1.4
  6.  
  7.                                     by
  8.                               Mark P. Harrison
  9.                       Documentation by: Chris Johnson
  10.                                  12/04/93
  11.  
  12.         Copyright 1992,93 by Mark P. Harrison.  All rights reserved.
  13.  
  14.  
  15.         LEGAL NOTICE:
  16.         =============
  17.  
  18.         PICK-UP is a Shareware product. It is NOT freeware or public
  19.         domain.  If you use PICK-UP you are expected to pay for it.
  20.         You can register PICK-UP at a cost of $10.00 (U.S. currency).
  21.         In return for your registration, you will be provided a key
  22.         to remove the "Registration Encouragement Feature" from this
  23.         and any future versions.
  24.  
  25.         PICK-UP IS PROVIDED ON AN "AS IS" BASIS WITHOUT WARRANTY OF
  26.         ANY KIND EXPRESSED OR IMPLIED.  IN NO EVENT WILL MARK P.
  27.         HARRISON BE LIABLE TO ANY USER FOR ANY DAMAGES, INCLUDING
  28.         ANY LOST PROFITS, LOST SAVINGS OR OTHER INCIDENTAL OR
  29.         CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OF OR INABILITY
  30.         TO USE THE PROGRAM, EVEN IF MARK P. HARRISON HAS BEEN
  31.         ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM
  32.         BY ANY OTHER PARTY.
  33.  
  34.         PICK-UP is a trademark of Mark P. Harrison
  35.  
  36.         SALT, SIMPLE, and Telix are trademarks of deltaComm
  37.         Development.  Use of Telix(tm) for longer than 45 days
  38.         without appropriate payment to deltaComm Development for
  39.         Telix is a violation of international Copyright Law.
  40.  
  41.         Packing List:
  42.         =============
  43.  
  44.         PICKUP.SLC      31826           Main PICK-UP Script.
  45.         PUCONFIG.SLC    7806            Configuration Script.
  46.         PICKUP14.DOC    35473           This Documentation File
  47.         HISTORY.TXT     1882            Version History
  48.         REGISTER.TXT    2543            Registration Form
  49.         FILE_ID.DIZ     611             Description File
  50.  
  51.  
  52.         Note to CompuServe User's:
  53.         ==========================
  54.  
  55.         If you downloaded PICK-UP from CompuServe, Please rename the
  56.         archive PICKUP14.ZIP before uploading it anywhere.
  57.  
  58.  
  59.  
  60.  
  61.                          TABLE of CONTENTS
  62.                          .................
  63.  
  64.  
  65.  
  66.                  What's New? ...................  1
  67.  
  68.                  Special Thanks ................  2
  69.  
  70.                  What is PICK-UP? ..............  3
  71.  
  72.                  Installation ..................  4
  73.  
  74.                  Starting PICK-UP ..............  5
  75.  
  76.                  Configuring PICK-UP ...........  6
  77.  
  78.                  Putting PICK-UP to Work .......  8
  79.  
  80.                  Regular Mode ..................  9
  81.  
  82.                  Message Mode .................. 10
  83.  
  84.                  Script Mode (SIMPLE) .......... 11
  85.  
  86.                  Script Mode (SALT) ............ 12
  87.  
  88.                  Miscellaneous ................. 14
  89.  
  90.                  Registration .................. 15
  91.  
  92.  
  93.                                                           Page -1-
  94.  
  95.            >>     PICK-UP Version 1.4 User's Guide    <<
  96.  
  97.         What's New?
  98.         ===========
  99.  
  100.         PICK-UP Version 1.4 is a maintenance release, plus a little
  101.         more.
  102.  
  103.         Completely new to PICK-UP 1.4 are:
  104.  
  105.                 - Timed Script Launching
  106.                 - SIMPLE Script Compiling
  107.                 - Expanded DOS functions for Creating, Deleting
  108.                   and Renaming Directories
  109.                 - Internal File Viewer
  110.                 - File size displayed in PICK-List
  111.  
  112.         Maintenance Features include:
  113.  
  114.                 - Improved Print Routine (now uses SALT function)
  115.                   and has configurable form feed option
  116.                 - Expanded User Documentation
  117.                 - Your name in the Screen Blanker box
  118.                 - Improved File Uploading procedure
  119.  
  120.  
  121.         New Features:
  122.  
  123.         Many PICK-UP user's have asked for a way to perform delayed
  124.         script launches in PICK-UP.  PICK-UP now will allow you to
  125.         set a time, like late at night, to perform mail runs or
  126.         unattended uploads with a user supplied script.
  127.  
  128.         Since SIMPLE has joined the Telix family, it is now
  129.         an option in Script mode.  SIMPLE scripts compiled with a
  130.         registered Telix CSS.EXE will automatically generate the
  131.         intermediate .SLT file, a great learning tool for aspiring
  132.         SALTwriters.  Shareware versions will also be compiled, but
  133.         no .SLT's will be generated.
  134.  
  135.         Enhanced directory functions have been added to keep you
  136.         from having to shell out to DOS for such routine tasks as
  137.         creating, deleting or renaming a directory.
  138.  
  139.         PICK-UP now includes an internal File Viewer.  If no File
  140.         Viewer is configured, PICK-UP will default to its own.
  141.  
  142.         The PICK-List has been updated to display the size of the
  143.         highlighted file.
  144.  
  145.  
  146.                                                            Page -2-
  147.  
  148.         Improved Features:
  149.  
  150.         Print jobs have been moved to a SALT function to promote
  151.         better compatibility across different platforms.  You will
  152.         notice the standard SALT "Printer Log" windows when printing
  153.         files, but it's worth the extra stability.  Also, a "Form
  154.         Feed" option has been added to PUCONFIG which allows you to
  155.         decide whether or not you want a form feed (page eject)
  156.         included with each print job.
  157.  
  158.         The Documentation has been expanded into more of a User's
  159.         Guide format.  It is intended to help new User's to PICK-UP
  160.         and telecommunications in general get "more/faster" in each
  161.         PICK-UP/Telix session.  Examples are included with the
  162.         SCRIPT Mode descriptions which allow you to create and
  163.         compile some sample SIMPLE and SALT scripts.
  164.  
  165.         The Screen Blanker Box now displays the name of the
  166.         registered user.
  167.  
  168.         File uploading has been improved.  Now you can highlight the
  169.         file you want to upload before going online.  When you are
  170.         ready to upload the file and invoke PICK-UP, the file will
  171.         still be highlighted so you can <Press>Alt-S immediately to
  172.         send the file.  This eliminated the step of having to cursor
  173.         through the PICK-List to find the file.
  174.  
  175.  
  176.  
  177.         SPECIAL THANKS:
  178.         ===============
  179.  
  180.         I would like to thank Chris Johnson for doing such complete
  181.         documentation for this version. Without his efforts, you would
  182.         be reading a list of my notes instead of a true users guide.
  183.         Thanks Chris (AKA: CompuMess INC.)!
  184.  
  185.         I would like to thank my wonderful wife for putting up with
  186.         being a "Computer Widow" while I worked on this new version.
  187.  
  188.         I thank all of my registered users and those that are soon to
  189.         be registered.
  190.  
  191.         I thank YOU for taking the time to give PICK-UP a try.
  192.  
  193.  
  194.                                                            Page -3-
  195.  
  196.         What is PICK-UP?
  197.         ================
  198.  
  199.         PICK-UP is a utility program, written completely in SALT,
  200.         designed to enhance your time spent using Telix.  PICK-UP
  201.         accomplishes this task with a full featured menu which
  202.         anticipates your needs.  The options offered allow you to
  203.         stay within the Telix environment minimizing the need to
  204.         shell out to DOS.  As a result, your Telix sessions will be
  205.         more productive saving you keystrokes, time and money.
  206.  
  207.         Using PICK-UP you can:
  208.  
  209.                 * Perform the most commonly used DOS commands
  210.  
  211.                 * Write, edit and print text/script files
  212.  
  213.                 * Run and/or Compile SALT/SIMPLE scripts
  214.  
  215.                 * Set a "timer" to run a script at a specified time
  216.  
  217.                 * Upload files and messages
  218.  
  219.                 * Load or change to a different Dialing directory
  220.  
  221.                 * Set a timed delay to start screen saver
  222.  
  223.  
  224.         PICK-UP is configurable, meaning you can set it up to match
  225.         your particular needs.  You determine how you want PICK-UP
  226.         to work for you and save the setup for future sessions.
  227.  
  228.         PICK-UP offers three modes to work in:
  229.  
  230.                 * REGULAR - for all files
  231.  
  232.                 * SCRIPT  - for SALT (.SLT .SLC) and SIMPLE (.SIM) files
  233.  
  234.                 * MESSAGE - for .MSG files
  235.  
  236.  
  237.         REGULAR mode is useful for performing general housekeeping
  238.         functions, helping you keep your files in order.  This mode
  239.         is also used for uploading files.
  240.  
  241.         SCRIPT mode makes the job of writing, compiling and running
  242.         SALT/SIMPLE scripts a breeze.  In SCRIPT mode you can quickly
  243.         jump out of your editor, compile the script, run the script
  244.         and return to the editor to make changes or continue coding.
  245.  
  246.         MESSAGE mode is for writing and sending messages. PICK-UP
  247.         makes it easy to write your messages offline and then
  248.         upload them quickly when you are online saving you connect
  249.         time on the BBS and possibly long distance charges.
  250.  
  251.  
  252.                                                            Page -4-
  253.  
  254.         Now with this out of the way, let's check a few things in
  255.         your Telix configuration and get PICK-UP installed.
  256.  
  257.  
  258.         Installing PICK-UP               Note: Instructions assume you
  259.         ==================                     are using Telix v3.21
  260.  
  261.    4.1  Configure Your Text Editor in Telix
  262.  
  263.         PICK-UP looks to your Telix configuration to see which text
  264.         editor you use, so you need to be sure it is defined.  If
  265.         you already have your editor configured, check to make sure
  266.         you've included the full path name, then skip to 4.2.  If
  267.         you don't have an editor configured, here's the steps you
  268.         must perform:
  269.  
  270.                 1.  Start Telix
  271.                 2.  <Press and Hold>Alt then <Press>O
  272.                 3.  <Press>F        (Filenames and Paths)
  273.                 4.  <Press>H        (Editor Name)
  274.                 5.  <Type> full path to your text editor
  275.                         Example:  C:\util\editor.exe
  276.                 6.  <Press>Enter twice
  277.                 7.  <Press>W        (to save your change)
  278.  
  279.    4.2  Configure Your Script Directory in Telix
  280.  
  281.         PICK-UP also looks to your Telix configuration to see where
  282.         your script files are stored.  If your script directory is
  283.         already defined, make sure you have included a trailing "\"
  284.         then skip to 4.3.  If you don't have a script directory, you
  285.         must create a subdirectory under your Telix directory to
  286.         hold script files i.e. C:\TELIX\SCRIPTS\. Now, to configure
  287.         Telix:
  288.  
  289.                 1.  <Start> Telix
  290.                 2.  <Press and Hold>Alt then <Press>O
  291.                 3.  <Press>F        (Filenames and Paths)
  292.                 4.  <Press>C        (Script Directory)
  293.                 5.  <Type> complete path to your script directory
  294.                         Ex.: C:\TELIX\SCRIPTS\ (Note trailing "\")
  295.                 6.  <Press>Enter twice
  296.                 7.  <Press>W  (to save your change)
  297.  
  298.  
  299.    4.3  Copy PICK-UP Files to your Telix Script Directory
  300.  
  301.         PICK-UP requires four files to be copied to your defined
  302.         Telix script directory: PICKUP.SLC, PUCONFIG.SLC, CS.EXE,
  303.         and CSS.EXE.  You can find CS.EXE, the SALT compiler, and
  304.         CSS.EXE, the SIMPLE compiler in your Telix root directory.
  305.         CS.EXE and CSS.EXE must be present in your Telix script
  306.         directory.
  307.  
  308.  
  309.                                                            Page -5-
  310.  
  311.         Starting PICK-UP
  312.         ================
  313.  
  314.    5.1  When you start Telix
  315.  
  316.         There are several ways to start PICK-UP, but in order to
  317.         realize its full potential, it's recommended to run it
  318.         automatically when you start Telix.  To do this, just add
  319.         "spickup" , (no quotes), to your Telix start up sequence.
  320.         From the DOS command line it would look like this:
  321.  
  322.         C:\TELIX>telix spickup      (Of course you will substitute
  323.                                      your own drive and directory
  324.                                      if they differ from this
  325.                                      example.)
  326.  
  327.         You will find that starting Telix with PICK-UP will result
  328.         in more productive Telix sessions.
  329.  
  330.         When you need to work from the Telix terminal screen, or
  331.         when you are online, you'll want a quick method to call
  332.         PICK-UP,
  333.  
  334.    5.2  Hot Key Method from the Terminal Screen or while Online
  335.  
  336.         The quickest and best way to start PICK-UP from the terminal
  337.         screen or while online is to create a keyboard macro.  You
  338.         can define a Hot Key sequence so that PICK-UP will always
  339.         be available when time is money.
  340.  
  341.         Here's how:
  342.  
  343.         Starting at the Telix terminal screen:
  344.  
  345.                 1.  <Press and Hold>Alt  then <Press>K
  346.                 2.  <Press>Enter    (for Regular table)
  347.                 3.  <Press>E        (for Edit)
  348.                 4.  <Type> the Hot Key combination or function key you
  349.                            wish to use.  For example Alt-P or F10
  350.  
  351.                 5.  <Type>@PICKUP   (to run PICK-UP when Hot Key is
  352.                                      pressed.)
  353.                 6.  <Press>spacebar (to exit Edit mode)
  354.                 7.  <Press>S        (to save your definition)
  355.                 8.  <Press>Enter    (writes definition to TELIX.KEY)
  356.                 9.  <Press>X or ESC (return to Terminal screen)
  357.  
  358.    5.3  Manual Method from the Telix Terminal Screen
  359.  
  360.         For all you diehards who prefer the manual method:
  361.  
  362.         Starting at the Telix terminal screen:
  363.  
  364.                 1.  <Press and Hold>Alt  then <Press>G
  365.                 2.  <Type>PICKUP and <Press>Enter
  366.  
  367.  
  368.                                                            Page -6-
  369.  
  370.         Configuring PICK-UP
  371.         ===================
  372.  
  373.         If you're already a Registered PICK-UP user, you can skip
  374.         this section.  For those of you who are "first timers", it's
  375.         time to start PICK-UP and configure some options.
  376.  
  377.         First you need to start PICK-UP from the command line, with
  378.         a Hot Key, or with Alt-G from the Terminal screen. You will
  379.         see the following message:
  380.                                                                                 
  381.                Running PUCONFIG the PICK-UP configuration script.
  382.  
  383.         and the PICK-UP Configuration screen will be displayed.
  384.  
  385.         The options you can configure are listed on the box titled,
  386.         "Change which settings?"  It's best to start at the top and
  387.         work your way down the list.  Don't worry if you can't make
  388.         up your mind about any of the options, you can always run
  389.         PUCONFIG later to make changes.
  390.  
  391.  
  392.         ----- OPTIONS -----
  393.         Foreground                 To configure options:
  394.         Background
  395.         Pick Border Fg             1. <Highlight> option using
  396.         Pick Border Bg                 up/down arrows
  397.         Pick Fg
  398.         Pick Bg                    2. <Press>Enter
  399.         Pick Bar Fg
  400.         Pick Bar Bg                3. <Use> left and right arrow
  401.         File Count Menu                keys to change colors
  402.         Fg Menu
  403.         Bg Menu                    or <Type> full path to your file
  404.         Key Letter                     view program.
  405.         File VIEW Program
  406.         Screen Blank Time          or <Type> number of seconds for
  407.         File Sort Method               Screen Blanker
  408.         Print FF Option
  409.         SAVE Settings & Exit       or <Select> a file sort method
  410.         Exit Without Saving
  411.                                    or <Select> form feed option
  412.  
  413.                                    4. <Press>Enter
  414.  
  415.                                    5. <Repeat> steps 1-4 until all
  416.                                        options are to your preference.
  417.  
  418.  
  419.  
  420.         Once you have your colors set, it's time to tell PICK-UP
  421.         where your ASCII File View utility program is located.
  422.         PICK-UP has a built in File Viewer that it will use if you
  423.         do not specify the full path name of an alternate utility.
  424.  
  425.  
  426.                                                            Page -7-
  427.  
  428.         Configuring PICK-UP (continued)
  429.         ===================
  430.  
  431.         PICK-UP requires that you enter a full path name for your
  432.         file view program.
  433.  
  434.         The Screen Blank Time is defaulted to 45 seconds.  To change
  435.         this time, enter the number of seconds you desire or enter 0
  436.         (zero) to disable screen blanking. Long time PICK-UP
  437.         users will be pleased to note that the Screen Blanker
  438.         message box now displays their name as used to register
  439.         PICK-UP.
  440.  
  441.         The next item to configure is the method you want PICK-UP to
  442.         use to display files in the PICK-List.  You have three
  443.         choices for file sorting.
  444.  
  445.                 NO SORT - The fastest method, but files are randomly
  446.                           displayed.
  447.  
  448.                 SORT 1  - Use this if you do not use another program
  449.                           to sort your directories and files.  Your
  450.                           files are displayed alphabetically making it
  451.                           easy to quickly search through long lists.
  452.  
  453.                 SORT 2  - Use this if you regularly run a disk utility
  454.                           program that sorts your directories and
  455.                           files alphabetically.
  456.  
  457.         The last item to configure is to choose whether or not you
  458.         want a form feed at the end of each print job.
  459.  
  460.         Once all options are configured, be sure to SAVE your
  461.         settings when you exit. The first time you configure PICK-UP
  462.         your changes will take effect immediately.
  463.  
  464.         If at a later date, you need to make changes to your PICK-UP
  465.         configuration, run PUCONFIG from the Telix terminal screen.
  466.         Here's how:
  467.  
  468.                 1. <Press>Alt-G at the Telix Terminal Screen
  469.  
  470.                 2. <Type>PUCONFIG
  471.  
  472.                 3. <Press>Enter
  473.  
  474.                 4. <Configure> Options
  475.  
  476.                 5. <Select> SAVE Settings and Exit
  477.  
  478.                 6. <Press>Enter
  479.  
  480.                 7. <Start> PICK-UP to see your new changes.
  481.  
  482.  
  483.                                                            Page -8-
  484.  
  485.         Putting PICK-UP to Work
  486.         =======================
  487.  
  488.  Modes- PICK-UP offers three modes to work in depending on the tasks
  489.         you need to perform. To alternate between modes, use the TAB
  490.         key and select from the box displayed at the bottom of your
  491.         screen.  The Mode you select will determine what types of
  492.         files will be displayed in the PICK-List on the left side of
  493.         your screen. Modes can be selected using the TAB, left/right
  494.         arrows, or the Key letter.
  495.  
  496.  Pick-  Use the Up/Down arrow keys,PgUp/PgDn, Home/End to highlight
  497.  List   a directory and then <Press>Enter to open the directory.
  498.         Again, the Mode you are in will dictate which types of files are
  499.         displayed.
  500.  
  501.         Tip: You can also use the forward slash '/' and back slash
  502.         '\' keys for quick directory changes.
  503.  
  504.             Regular Mode -  All files are displayed
  505.             Message Mode - .MSG files are displayed
  506.             Script Mode  - .SLT or .SLC or .SIM files are displayed
  507.  
  508.  Menu-  PICK-UP has a smart Menu whose options change depending upon
  509.         what is highlighted in the Pick List, what Mode you have
  510.         selected, or whether or not you are online.  They are:
  511.  
  512.         ENTER = View/Cd    - Files are viewed. Directories changed
  513.             C = Copy       - Copies selected file to typed path
  514.             M = Move       - Moves selected file to typed path
  515.             R = Rename     - Rename a file or directory
  516.             D = Delete     - Deletes file or (empty) directory
  517.             E = Edit       - Edit selected file
  518.             P = Print      - Print selected file
  519.             W = Write      - Opens a new file for editing
  520.           INS = Make Dir   - Creates a new directory
  521.             H = Help       - Invokes Help Screen
  522.             U = Update     - Refreshes directory in PICK-List
  523.                              when files are written or deleted
  524.                              outside of PICK-UP
  525.         ALT-S = Send       - Sends Message or Uploads File
  526.         ALT-D = Dial       - Opens the current Dialing Directory
  527.         CTL-D = New Dial   - Open another Dialing Directory
  528.         ALT-J = DOS Jump   - Shell to DOS
  529.         ALT-C = Compile    - Compiles selected script file (.SIM/.SLT)
  530.         ALT-G = Run SLC    - Highlighted file in Script dir. (Script
  531.                              Mode).  Other Modes <Type>filename
  532.         CTL-G = Launch SLC - Set time for future event
  533.             \ = Cd/Drive   - Change current working drive/directory
  534.           TAB = Mode       - Change current mode
  535.             S = Save CFG   - Saves current Menu settings
  536.           ESC = Exit       - Exit PICK-UP
  537.         ALT-X = Exit TELIX - Exit PICK-UP and Telix
  538.  
  539.  
  540.                                                            Page -9-
  541.  
  542.         REGULAR Mode:
  543.         =============
  544.  
  545.         Offline -
  546.  
  547.         Regular Mode allows you access to all files in the PICK-List.
  548.         You can perform the most commonly used DOS functions for
  549.         maintaining your files.
  550.  
  551.         Online / Uploading Files -
  552.  
  553.         Here's where PICK-UP can save you time and money.  PICK-UP
  554.         remembers what directory you were in and the file you have
  555.         highlighted when you go online. So when you're ready to
  556.         upload the file you will be able to quickly send it.  This
  557.         process has been significantly improved in Version 1.4 to
  558.         immediately display the directory and highlighted file you
  559.         had specified before going online.
  560.  
  561.  
  562.         An Upload Example:
  563.  
  564.         1.  <Highlight>the desired file to upload using PICK-UP
  565.  
  566.         2.  <Press>Alt-D to load your Dialing directory and
  567.             make your call.
  568.  
  569.         3.  <Perform>the normal steps to upload a file as required
  570.             by the BBS you are calling.
  571.  
  572.         4.  When the BBS is ready to receive your file:
  573.  
  574.                 - <Press>your PICK-UP Hot-Key
  575.  
  576.                 - <Press>Alt-S  (to send the highlighted file
  577.  
  578.                 - <Select>the desired protocol
  579.  
  580.             PICK-UP will upload your file.
  581.  
  582.  
  583.  
  584.  
  585.  
  586.         Note:  Due to a problem with Telix 3.20, non-message mode
  587.                uploading does not work with this single Telix
  588.                version.  This problem was fixed in Telix Version
  589.                3.21 and did not exist in versions before 3.20.
  590.  
  591.  
  592.                                                           Page -10-
  593.  
  594.         MESSAGE Mode:
  595.         ============
  596.  
  597.         Message Mode is especially useful for handling non-mail
  598.         packet messages.  When you select Message Mode, only files
  599.         with the extension .MSG will be displayed in the PICK-List.
  600.         The greatest advantage to Message Mode is that you can
  601.         compose messages offline and then upload them using ASCII
  602.         protocol when online with a significant savings in time.
  603.  
  604.         The Message process can best be described in steps.
  605.  
  606.         From the PICK-UP Menu:
  607.  
  608.             - <Select>a directory to hold your message file
  609.             - <Press>TAB and <Select>MESSAGE
  610.             - <Press>W and <Type><filename>.MSG and <Press>Enter
  611.             - <Type>your message and save with Text Editor
  612.  
  613.               You're now back to PICK-UP and the message you
  614.               just wrote is highlighted.
  615.  
  616.             - <Press>Alt-D to start Dialing directory
  617.             - <Call>BBS
  618.             - <Perform> the normal steps on the BBS for entering a
  619.               message including entering SUBJECT: and To:.  When
  620.               you're at the point where you'd normally start typing
  621.               the body of your message...
  622.  
  623.             - <Press>your Hot-Key for PICK-UP.
  624.             - <Press>Alt-S (to send the highlighted message file)
  625.  
  626.               Your message will now be sent to the BBS in a fraction
  627.               of the time it would normally take you to type it.
  628.               When the message has finished being sent.
  629.  
  630.               Now control returns to the BBS...
  631.  
  632.             - <Save>the message using the steps normal for your BBS
  633.             - You're on the BBS to either continue with other
  634.               business or exit.  When you do exit the BBS, you'll
  635.               be returned to PICK-UP.
  636.  
  637.         Remember that in MESSAGE Mode only files with the extension
  638.         .MSG will be displayed.  If you are working with ASCII files
  639.         with extensions other than .MSG, you can use PICK-UP's
  640.         (R)ename or (C)opy functions to convert these files to *.MSG
  641.         files.
  642.  
  643.         You can also use PICK-UP to compose messages while online
  644.         using your own familiar editor, instead the of BBS's editor.
  645.         Once your message is composed, you can use PICK-UP to send
  646.         it.  If you do use this method remember, you are subject to
  647.         the inactivity time as defined by your BBS, so it's normally
  648.         better to prepare your messages offline.
  649.  
  650.  
  651.                                                           Page -11-
  652.  
  653.         SCRIPT Mode:
  654.         ============
  655.  
  656.         PICK-UP now supports SALT and SIMPLE language files.  Using
  657.         SCRIPT Mode you can minimize the edit-compile-run cycle to
  658.         make your time spent programming more productive.
  659.  
  660.         When you start SCRIPT Mode you choose between .SLT .SLC and
  661.         .SIM files.  The type you choose will be the only type
  662.         displayed in the PICK-List.
  663.  
  664.         When compiling SIMPLE scripts, registered Telix user's
  665.         should note that PICK-UP will create the intermediate .SLT
  666.         file by default (not supported for unregistered Telix copies).
  667.         The .SLT files can be studied to learn more about SALT.
  668.  
  669.         Perhaps the best way to demonstrate the power of this
  670.         feature is to write some small scripts in SIMPLE and SALT
  671.         that you can compile and run.  
  672.  
  673.         Let's start with a SIMPLE script.  The quickest way to get
  674.         started is to:
  675.  
  676.                 1. <Press>TAB and <Select>SCRIPT then <Select>SIM
  677.                 2. <Press>the "/" or "\" keys to jump to your
  678.                           Script directory.
  679.  
  680.                 3. <Press>W and <Type>SIMDEMO.SIM and <Press>Enter
  681.                 4. <Type>the following exactly as it appears:
  682.  
  683.                 //SIMDEMO.SIM - PICK-UP Demo for SIMPLE
  684.                 clearscreen
  685.                 sound 220, 30
  686.                 sound 440, 60
  687.                 date string1
  688.                 time string2
  689.                 message string1
  690.                 show string2 enter
  691.                 wait 30
  692.  
  693.                 5. <Save>SIMDEMO.SIM with your Text Editor
  694.                 6. <Press>Alt-C to compile script.  If you made no
  695.                     mistakes, you will see:
  696.  
  697.                     CSS v2.0 - Telix{tm} v3.21 SIMPLE script compiler.
  698.                                                                                 
  699.                     CSS done...
  700.                                                                                 
  701.                     Press any key to continue...
  702.  
  703.         If you get the CSS Done message, skip to Step 7.
  704.  
  705.  
  706.                                                           Page -12-
  707.  
  708.         SCRIPT Mode: (continued)
  709.         ==================
  710.  
  711.         If you instead get a compiler error message, it means you
  712.         made a typo, and are only human <G>.  Here's how to fix it:
  713.  
  714.                     - <Press>any key to continue
  715.                     - <Press>E to edit SIMDEMO.SIM
  716.                     - <Find>the mistake and correct it
  717.                     - <Save>SIMDEMO.SIM
  718.                     - <Go Back>to Step 6.
  719.  
  720.                 7. <Press>Alt-G to run SIMDEMO.SIM
  721.  
  722.         To get a feel for the power of PICK-UP, try making changes
  723.         to SIMDEMO.SIM.  See how fast you can go from editing to
  724.         compiling to running the script.  Refer to your Telix Manual
  725.         for other SIMPLE commands you can try with SIMDEMO.SIM or
  726.         write some scripts of your own.
  727.  
  728.         If you're a registered Telix user, take a look at
  729.         SIMDEMO.SLT to see the intermediate file created by the
  730.         SIMPLE compiler. Above all, don't worry about making
  731.         mistakes.  The process of writing scripts/programs rarely
  732.         meets with success on the first try!
  733.  
  734.         Now let's write a SALT script.
  735.  
  736.                 1. <Press>TAB and <Select>SCRIPT then <Select>SLT
  737.                 2. <Press>the "/" or "\" key to jump to your
  738.                           Script directory.
  739.                 3. <Press>W and <Type>SLTDEMO.SLT and <Press>Enter
  740.                 4. <Type>the following exactly as it appears:
  741.  
  742.         //SLTDEMO.SLT - PICK-UP SALT script demo
  743.  
  744.         str  s_1[8], s_2[8];
  745.  
  746.         main()
  747.         {
  748.             clear_scr();
  749.             box (11,11,71,21,0,0,0);
  750.             box (10,10,70,20,3,0,113);
  751.             pstraxy ("Today's date: ", 12,12,113);
  752.             date(curtime(),s_1);
  753.             pstraxy (s_1, 33,12,31);
  754.             pstraxy ("The Current time is: ", 12,14,113);
  755.             time(curtime(),s_2);
  756.             pstraxy (s_2, 33,14,31);
  757.             pstraxy ("PICK-UP makes script writing easy!", 23,18,116);
  758.             cursor_onoff(0);
  759.             delay(50);
  760.             cursor_onoff(1);
  761.             clear_scr();
  762.         }
  763.  
  764.  
  765.                                                           Page -13-
  766.  
  767.         SCRIPT Mode: (continued)
  768.         ===================
  769.  
  770.                 5. <Save>SLTDEMO.SLT with your Text Editor
  771.                 6. <Press>Alt-C to compile script.  If you made no
  772.                     mistakes, you will see:
  773.  
  774.                     CS done...
  775.                     Press any key to continue...
  776.  
  777.         If you instead get a compiler error message, it means you
  778.         made a typo.  Note in the error message which line in the
  779.         script is triggering the error. (Note: many times the error
  780.         is actually in the line before the one listed by the
  781.         compiler.) Here's how to fix it:
  782.  
  783.                     - <Press>any key to continue
  784.                     - <Press>E to edit SLTDEMO.SLT
  785.                     - <Find>the mistake and correct it
  786.                     - <Save>SLTDEMO.SIM
  787.                     - <Go Back>to Step 6.
  788.  
  789.                 7. <Press>Alt-G to run SLTDEMO.SIM
  790.  
  791.         Again, to get a better feel of the power of PICK-UP, try
  792.         making some changes to SLTDEMO.SLT.  Refer to the SALT
  793.         Manual on how to change colors, line positions or how long
  794.         the script is displayed on the screen.  You'll see how easy
  795.         it is to write and test your SALT code.
  796.  
  797.  
  798.                                                           Page -14-
  799.  
  800.         MISCELLANEOUS:
  801.         ==============
  802.  
  803.         Here's some more features offered by PICK-UP :
  804.  
  805.         Selecting a new Dialing Directory -
  806.  
  807.             <Press>Ctrl-D to display a PICK-List listing all your
  808.              Dialing Directories.
  809.  
  810.  
  811.         Telix Hot-Keys -
  812.  
  813.             Any Keyboard Macros you have defined in Telix, that
  814.             don't conflict with PICK-UP's Menu Keys will run
  815.             in PICK-UP.
  816.  
  817.  
  818.         Saving your PICK-UP Configuration -
  819.  
  820.             <Press>S to save the current Mode and Directory as your
  821.              default for the next time you run PICK-UP.
  822.  
  823.  
  824.         Exiting PICK-UP and/or Telix -
  825.  
  826.             <Press>ESC to exit PICK-UP or <Alt-X>for PICK-UP and
  827.              Telix.
  828.  
  829.  
  830.         Manually Invoking the Screen Blanker -
  831.  
  832.             This feature is not listed on PICK-UP's menu or Help
  833.             Screen, but you can manually start the Screen Blanker
  834.             if you <Press>B or b.  This will start the Screen
  835.             Blanker even if you have disabled it in PUCONFIG.
  836.  
  837.  
  838.  
  839.  
  840.         NOTE: If you add or delete any files using some program other
  841.               than PICK-UP, those files will not be displayed correctly
  842.               in the PICK-List until you use Update (option U).
  843.  
  844.  
  845.                                                           Page -15-
  846.  
  847.    REGISTRATION
  848.    ============
  849.             If you experience a problem or if you have a suggestion
  850.             for an improvement and/or addition to this script feel
  851.             free to write me.
  852.             ┌──────────────────────────────┐
  853.             │   Mark P. Harrison           │
  854.             │   6676 Robinson School Rd.   │
  855.             │   New Athens, IL 62264   USA │
  856.             │   FidoNet: Telix Echo        │
  857.             │   FidoNet: 1:2250/23         │
  858.             │   BBS: (618)539-6254         │
  859.             └──────────────────────────────┘
  860.             There is a fee of $10.00 (US) for the use of this script.
  861.  
  862.             If you find this script useful, please complete the form
  863.             below and send it along with your payment to the above
  864.             address. In return for the $10 registration fee, you will
  865.             receive a key to remove the "REGISTRATION ENCOURAGEMENT
  866.             FEATURE" from this AND any future versions. I encourage
  867.             you to pass this script around to your friends. Thank you
  868.             for your support.
  869.                                                     Mark P. Harrison
  870.  
  871.                                ** PICK-UP **
  872.                                     1.4
  873.                              REGISTRATION FORM
  874.  
  875.         SHIP TO NAME:________________________________________________
  876.  
  877.              ADDRESS:________________________________________________
  878.  
  879.                      ________________________________________________
  880.  
  881.                      ________________________________________________
  882.  
  883.         REGISTER TO:
  884.         ┌─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┐
  885.         │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │
  886.         └─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┴─┘
  887.         (This is what you want to appear on your registered copy.)
  888.                                 (30 Max.)
  889.  
  890.         Where did you hear about PICK-UP? ___________________________
  891.  
  892.         Where did you get your copy of PICK-UP? _____________________
  893.  
  894.         Voice Phone: _________________  BBS Phone: __________________
  895.          (Optional)
  896.  
  897.         FIDO NetMail address if you have one: _______________________
  898.  
  899.         Comments:____________________________________________________
  900.  
  901.                  ____________________________________________________
  902.  
  903.                  ____________________________________________________
  904.  
  905.